Ñ Install over OpenDoc¬ Developer release versions 1 through 3.
Ñ Install onto a "clean" machine.
A clean machine is one that does not contain earlier versions of OpenDoc or the libraries and extensions on which it depends. Below you'll find instructions for installing OpenDoc and for cleaning up your machine. We also make suggestions for rearranging the files added by the Installer (useful for part developers who need to accommodate a development system.)
Installing OpenDoc:
To install OpenDoc libraries and the extensions, double-click on the Installer application in the same folder as this document, or launch it by dropping the file "Install OpenDoc" onto it.
The Installer, once launched, gives you two options: Easy Install and Custom Install.
Easy Install checks whether your machine is a PowerMac or 68K Macintosh, and installs the right software for its architecture. This is probably the option to choose if you will always run the target hard drive with the same architecture (PowerMac or 68K Macintosh).
Note that OpenDoc 1.0 should only be installed on 68K Macs running System 7.1.1 or greater, and on PowerMacs running System 7.1.2 or greater. You can't use Easy Install to install onto a disk that does not have a blessed System folder. It is possible to use Custom Install to get around these restrictions, but you'll probably wish you hadn't.
Installing over previous versions of OpenDoc¬
It is recommended to boot your system with extensions off before installing. The installer should take care of most of the work upgrading from older versions of OpenDoc¬ based on SOMobjects¬ for Mac¬ OS (SOM). After installing there may be both an "OpenDoc¬" folder and an "OpenDoc" folder. Remove the folder that has the ¬ on the end of the name (OpenDoc¬).
Creating a "clean" system:
We recommend that you install fresh System software from Apple-supplied disks if you think you might have any conflicts. But if you would rather not do this, try manually removing the following files from your hard drive. They're about to be replaced with equivalent files anyway. We think this list is complete, but can make no guarantees.
From your Extensions folder, remove the following files if they exist:
CFM68K
MixedModeInit
MixedMode68KInit
NuDragLib.slb
NuIntEnv.slb
NuInterfaceLib.slb
NuStdCLib.slb
Clipping Extension
SOM
In addition, if there are any aliases in the Extensions folder make sure they don't lead to any of old files, or to old OpenDoc libraries.
What you've got, and what you can do with it:
OpenDoc uses SOMObjects¬ for Mac¬ OS, which on the Mac uses the Code Fragment Manager that's integral to PowerMacs and installed separately for 68K Macs by the OpenDoc Installer. Code Fragments, including the SOM libraries that make up OpenDoc, must either be located in the Extensions folder or in folders aliased from there. We begin by installing the bulk of the libraries you'll need in a folder in the Extensions folder, and put part editor libraries in the Editors folder in the System folder.